Skip to main content

Step by Step Configuration

Greetings and welcome to IO River! The primary objective of this guide is to aid new users, like yourself, in rapidly implementing a Multi-Edge platform strategy utilizing IO River. Our intention is to assist you in improving the reliability and performance of your websites and applications while also reducing the cost of your edge services. Our primary aim is to assist you in unlocking the full potential of the IO River platform.

1. Create an account on IO River​

Please feel free to contact us by sending an email to support@ioriver.io or booking a demo through our website at www.ioriver.io. We would be delighted to create an account for you.

Once your account is created, the IO River support team will provide you with a username (email) and password that you can use to access the IO River platform.

2. Login to IO River management console​

Please browse to the IO River website at www.ioriver.io and click on the "Login" button:

Login Screen

3. Upload your certificate​

Please upload your certificate to IO River, IO River will upload your certificate to all chosen CDNs / Edge platforms. Choose “TLS CERTIFICATES” tab and click on the “ADD CERTIFICATE” button:

TLS Tab

Please enter the certificate name, private key, certificate itself, and the certificate chain. Please note that all fields are mandatory. Once you have entered the required information, click on the "SAVE" button to proceed.

Add Certificate

4. Connect your CDNs / Edge vendors​

Please select which CDN/Edge platforms you would like to utilize. At present, IO River supports the following platforms:

  • CloudFlare
  • CloudFront
  • Fastly
  • Akamai
  • Azure CDN

To choose a CDN provider, click on the "CDN Providers" tab and select the desired provider from the dropdown menu:

Login Screen

For each provider, you will need to specify the required access details, such as access token. Here's how you can create the necessary access token for each CDN provider:

Once you have entered the necessary access token details, click on the "APPLY" button to proceed.

5. Create your first service on IO River​

A "Service" in IO River represents a portion of your traffic and is equivalent to a CloudFlare website, a CloudFront distribution, a Fastly service, and so on. To create a new service, please click on the "SERVICES" tab and then click on the "ADD SERVICE" button:

Services Tab

Please specify your service name, domain name, domain to your origin, description, and choose your predefined TLS certificate:

Add Service

6. Select which CDN providers will serve your service​

To access your created service, please click on the drill-down icon located inside the service. The drill-down icon will appear once you hover your mouse over the selected service:

Drill Down

Select the "CDN Providers" tab and choose from the dropdown menu which providers to add. Please use the "ADD" button to add the providers to your service.

Choose Providers

7. Distribute the traffic across chosen CDN providers​

Configure the default traffic policy via the "TRAFFIC POLICIES" tab:

Traffic Policy

Select which CDN providers you would like to serve your service by default (across all geographies):

Traffic Policy - Modify - Choose Providers

Choose which traffic switching method will be used to distribute traffic between the chosen vendors. IO River supports two methods:

  • Dynamic - Based on performance (latency) of the CDN providers in chosen geography
  • Static - Based on static distribution of traffic between the chosen vendors In this article, we will choose to switch traffic by static method. More information regarding the traffic policies could be found in “Traffic Policies” article.

Traffic Policy - Modify - Choose Providers

Set the traffic weights (totaling 100%) for your chosen CDN providers, and click on the "APPLY POLICY" button to proceed.

Traffic Policy - Modify - Choose Providers

8. Integrate with your DNS​

Your service is ready for integration with DNS. Return back to main “SERVICE” tab clicking on “IO RIVER” logo:

Back Home

Copy the IO River CNAME for your service:

Copy CNAME

Configure the IO River CNAME as a CNAME to your DNS name.

Congratulations! Your first IO River service is ready for use.